home *** CD-ROM | disk | FTP | other *** search
/ Products & Services for NeXT / Products & Services for NeXT.iso / AlembicDemo.app / ScriptWriter / CommandGroups / Tape.cmdgrp (.txt) < prev    next >
Encoding:
NeXT TypedStream Data  |  1993-07-19  |  108.7 KB  |  1,163 lines

  1. typedstream
  2. CommandGroup
  3. Object
  4. [10@]
  5. Command
  6. NXImage
  7. NXBitmapImageRep
  8. NXImageRep
  9. iisssss00
  10. [576c]UUUUUUUUUUU@s
  11. fffff
  12. fffffff@
  13. r(fjd
  14. &ffffff`
  15. T&fffffd
  16. DDDD?
  17. DDDD@
  18. UUUUUUUUUUX
  19. NXCachedImageRep
  20. iiiiii00
  21. [4608c]e_U_U_U_T_U_U_U_e_U_eoU_U_U_eoU_eoU_eoU_T_U_e_UOe_U_U_U_T_U_UoU_eoU_e_U_eoU_U_UOU_U_UoU_e_
  22. S?b?0
  23. R?S?0
  24. S/r?c?
  25. R?2/0
  26. b?S?R?C/0
  27. c?b?b/r?b/0
  28. U_3?4?
  29. 3/B/R/0
  30. b/r?C/S?T?S?
  31. SOC?C?
  32. b/b/R
  33. CO"/3?
  34. C/R/S/r?b
  35. r?b/b?0
  36. #?"?b?@
  37. #?"/3?2?2/ 
  38. /b/a/@
  39. /R/S/R?S/cOR/
  40. 3?2?3/B?2/C?3/
  41. 3?3?#/2/3/"/4?2/C?B?C/0
  42. e_vouo
  43. /a/R/B/
  44. R?A/R?B?"?#/C?3/3?#/2?#/2?
  45. S?R?2/B?$?#?#/3?#?#?#/3?3?3O#/3?#?"?#?3?
  46. 3Ofov
  47. q?r/0
  48. CO"/3?"/3?"/B?"/2?
  49. 3Ofov
  50. tOb?r/
  51. voSOP
  52. fogoe
  53. q/b/0
  54. VoUoUof
  55. VovoU_ 
  56. C?dod_
  57. WoVoVof
  58. V_foe_doeoeo
  59. e_d_UOe_EOU_U_U_F_EoF_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_EOU_UoeoF_EoF_U_V_UoF_E_VoUoE_Uo
  60. incremental dump format
  61. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  62. \margl40
  63. \margr40
  64. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b\i0\ulnone\fs24\fc0\cf0 dump
  65. \b0  copies to optical disk or magnetic tape all files changed after a certain date in the filesystem. The key specifies the date and other options about the dump. Key consists of characters from the set 0123456789fusdoOWn.\
  66. If no arguments are given, the key is assumed to be 9u and a default file system is dumped to the default tape.\
  67.  Dump requires operator intervention on these conditions: end of removable disk or tape, end of dump, removable disk or tape write error, removable disk or tape open error or disk read error (if there are more than a threshold of 32). In addition to alerting all operators implied by the n key, dump interacts with the operator on dump's control terminal at times when dump can no longer proceed, or if something is grossly wrong. All questions dump poses must be answered by typing "yes" or "no", as appropriate.\
  68. Since making a dump involves a lot of time and effort for full dumps, dump checkpoints itself at the start of each tape or removable disk volume. If writing the tape volume fails for some reason, dump will, with operator permission, restart itself from the checkpoint after the old tape has been rewound and removed, and a new tape has been mounted. If writing the removable disk fails for some reason, dump will prompt the operator to restart from the checkpoint after the old removable disk has been ejected and the new removable disk has been inserted.\
  69. Dump tells the operator what is going on at periodic intervals, including usually low estimates of the number of blocks to write, the number of removable disks or tapes it will take, the time to completion, and the time to the disk or tape change. The output is verbose, so that others know that the terminal controlling dump is busy, and will be for some time.\
  70. Dump looks in /etc/swaptab for swapfiles that reside on the filesystem being dumped. If any matches are found, those files are not included in the dump.\
  71. Now a short suggestion on how to perform dumps. Start with a full level 0 dump\
  72. dump 0un
  73. \b0 \
  74. Next, dumps of active file systems are taken on a daily basis, using a modified Tower of Hanoi algorithm, with this sequence of dump levels: 3 2 5 4 7 6 9 8 9 9 ... For the daily dumps, a set of 10 tapes per dumped file system is used on a cyclical basis. Each week, a level 1 dump is taken, and the daily Hanoi sequence repeats with 3. For weekly dumps, a set of 5 OD's or tapes per dumped file system is used, also on a cyclical basis. Each month, a level 0 dump is taken on a set of fresh OD's or tapes that is saved forever.\
  75. DUMPING TO REMOVABLE DISK\
  76. On systems where Workspace Manager is running, the operator should wait intil the Insert Disk panel appears before inserting a disk. Otherwise, autodiskmount(1) will try to mount the disk on behalf of the Workspace Manager.\
  77. For example, to perform a level X dump to the internal floppy disk, use a command of the following form:\
  78. dump XOf 2.6 /dev/rfd0a
  79. \b0 \
  80. DUMPING TO EXABYTE TAPE\
  81. When used with the Exabyte tape drive, one 120-minute 8mm tape will hold 2.131 billion bytes (or 1.985 GB, where "giga" is 1024^3). This is the equivalent of 1,332,183 feet of 1600bpi reel-to-reel tape. So, a dump which wanted to use "almost all" of the Exabyte tape would specify:\
  82. \b dump Xfs... /dev/nrxt0 1200000 ...
  83. \b0 \
  84. (or similarly with /dev/rxt0).
  85. [19@]
  86. CommandOption
  87. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  88. \margl40
  89. \margr40
  90. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 This number is the `dump level'.  All files modified since the last date stored in the file /etc/dumpdates for the same filesystem at lesser levels will be dumped. If no date is determined by the level, the beginning of time is assumed; thus the option 0 causes the entire filesystem to be dumped.
  91. 9{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  92. \margl40
  93. \margr40
  94. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Place the dump on the next argument file instead of the tape or optical disk. If the name of the file is ``-'', dump writes to standard output.
  95. CommandArgument
  96. filename
  97. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  98. \margl40
  99. \margr40
  100. \pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc0\cf0 The file to place the dump on
  101. G{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  102. \margl40
  103. \margr40
  104. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 If the dump completes successfully, write the date of the beginning of the dump on file /etc/dumpdates. This file records a separate date for each filesystem and each dump level. The format of /etc/dumpdates is readable by people, consisting of one free format record per line: filesystem name, increment level and ctime(3) format dump date. /etc/dumpdates may be edited to change any of the fields, if necessary.
  105. }{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  106. \margl40
  107. \margr40
  108. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The size of the dump tape is specified in feet. The number of feet is taken from the next argument. When the specified size is reached, dump will wait for reels to be changed. The default tape size is 2300 feet.
  109. numfeet
  110. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  111. \margl40
  112. \margr40
  113. \pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc0\cf0 The number of feet of the dump tape
  114. H{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  115. \margl40
  116. \margr40
  117. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The density of the tape, expressed in BPI, is taken from the next argument. This is used in calculating the amount of tape used per reel. The default is 1600.
  118. density
  119. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  120. \margl40
  121. \margr40
  122. \pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc0\cf0 The density of the tape, in BPI
  123. /{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  124. \margl40
  125. \margr40
  126. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Dump tells the operator what file systems need to be dumped. This information is gleaned from the files /etc/dumpdates and /etc/fstab. The W option causes dump to print out, for each file system in /etc/dumpdates the most recent dump date and level, and highlights those file systems that should be dumped. If the W option is set, all other options are ignored, and dump exits immediately.
  127. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  128. \margl40
  129. \margr40
  130. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Is like W, but prints only those filesystems which need to be dumped.
  131. '{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  132. \margl40
  133. \margr40
  134. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Whenever dump requires operator attention, notify by means similar to a wall(1) all of the operators in the group "operator".
  135. 1{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  136. \margl40
  137. \margr40
  138. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Specifies that the device to dump to is a removable disk. The NeXT OMD-1 Optical Disk is the default drive when this flag is specified.
  139. E{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  140. \margl40
  141. \margr40
  142. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 When dumping to an optical or floppy disk, the size of the disk, expressed in megabytes (1048576 bytes), is taken from the next argument, so it's after any more characters in the key. For example, the size of a NeXT OMD-1 Optical Disk is 237 megabytes. You can, and sometimes must, specify a non-integral size; an extended density floppy disk is 2.6 megabytes. See /etc/disktab for information on disk geometry.
  143. disksize
  144. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  145. \margl40
  146. \margr40
  147. \pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc0\cf0 The size of the destination disk in megabytes
  148. filesystem
  149. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  150. \margl40
  151. \margr40
  152. \pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc0\cf0 The filesystem to be dumped
  153.     /usr/etc/
  154. UUUUUUUUUUU@s
  155. fffff
  156. fffffff@
  157. r(fjd
  158. &ffffff`
  159. T&fffffd
  160. DDDD?
  161. DDDD@
  162. UUUUUUUUUUX
  163. e_U_U_U_T_U_U_U_e_U_eoU_U_U_eoU_eoU_eoU_T_U_e_UOe_U_U_U_T_U_UoU_eoU_e_U_eoU_U_UOU_U_UoU_e_
  164. S?b?0
  165. R?S?0
  166. S/r?c?
  167. R?2/0
  168. b?S?R?C/0
  169. c?b?b/r?b/0
  170. U_3?4?
  171. 3/B/R/0
  172. b/r?C/S?T?S?
  173. SOC?C?
  174. b/b/R
  175. CO"/3?
  176. C/R/S/r?b
  177. r?b/b?0
  178. #?"?b?@
  179. #?"/3?2?2/ 
  180. /b/a/@
  181. /R/S/R?S/cOR/
  182. 3?2?3/B?2/C?3/
  183. 3?3?#/2/3/"/4?2/C?B?C/0
  184. e_vouo
  185. /a/R/B/
  186. R?A/R?B?"?#/C?3/3?#/2?#/2?
  187. S?R?2/B?$?#?#/3?#?#?#/3?3?3O#/3?#?"?#?3?
  188. 3Ofov
  189. q?r/0
  190. CO"/3?"/3?"/B?"/2?
  191. 3Ofov
  192. tOb?r/
  193. voSOP
  194. fogoe
  195. q/b/0
  196. VoUoUof
  197. VovoU_ 
  198. C?dod_
  199. WoVoVof
  200. V_foe_doeoeo
  201. e_d_UOe_EOU_U_U_F_EoF_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_EOU_UoeoF_EoF_U_V_UoF_E_VoUoE_Uo
  202. "magnetic tape manipulating program
  203. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  204. \margl40
  205. \margr40
  206. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b\i0\ulnone\fs24\fc0\cf0 mt
  207. \b0  is used to give commands to a magnetic tape drive. If a tape name is not specified, mt uses the device /dev/rxt0. Note that tapename must reference a raw (not block) tape device. By default mt performs the requested operation once. Operations may be performed multiple times by specifying count. The available commands are listed below. Only as many characters as are required to uniquely identify a command need be specified.Mt returns a 0 exit status when the operation(s) were successful, 1 if the command was unrecognized, and 2 if an operation failed.
  208. [11@]
  209. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  210. \margl40
  211. \margr40
  212. \pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc0\cf0 Used to specify a certain tape name
  213. tapename
  214. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  215. \margl40
  216. \margr40
  217. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Write count end-of-file marks at the current position on the tape
  218. count
  219. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  220. \margl40
  221. \margr40
  222. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Write count end-of-file marks at the current position on the tape
  223. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  224. \margl40
  225. \margr40
  226. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The number of times the command is to be executed
  227. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  228. \margl40
  229. \margr40
  230. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Forward space count files
  231. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  232. \margl40
  233. \margr40
  234. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Forward space count records
  235. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  236. \margl40
  237. \margr40
  238. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Back space count files
  239. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  240. \margl40
  241. \margr40
  242. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Back space count records
  243. rewind
  244. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  245. \margl40
  246. \margr40
  247. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Rewind the tape (Count is ignored)
  248. offline
  249. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  250. \margl40
  251. \margr40
  252. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Rewind the tape and place the tape unit off-line
  253. rewoffl
  254. status
  255. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  256. \margl40
  257. \margr40
  258. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Print status information about the tape unit
  259. UUUUUUUUUUU@s
  260. fffff
  261. fffffff@
  262. r(fjd
  263. &ffffff`
  264. T&fffffd
  265. DDDD?
  266. DDDD@
  267. UUUUUUUUUUX
  268. e_U_U_U_T_U_U_U_e_U_eoU_U_U_eoU_eoU_eoU_T_U_e_UOe_U_U_U_T_U_UoU_eoU_e_U_eoU_U_UOU_U_UoU_e_
  269. S?b?0
  270. R?S?0
  271. S/r?c?
  272. R?2/0
  273. b?S?R?C/0
  274. c?b?b/r?b/0
  275. U_3?4?
  276. 3/B/R/0
  277. b/r?C/S?T?S?
  278. SOC?C?
  279. b/b/R
  280. CO"/3?
  281. C/R/S/r?b
  282. r?b/b?0
  283. #?"?b?@
  284. #?"/3?2?2/ 
  285. /b/a/@
  286. /R/S/R?S/cOR/
  287. 3?2?3/B?2/C?3/
  288. 3?3?#/2/3/"/4?2/C?B?C/0
  289. e_vouo
  290. /a/R/B/
  291. R?A/R?B?"?#/C?3/3?#/2?#/2?
  292. S?R?2/B?$?#?#/3?#?#?#/3?3?3O#/3?#?"?#?3?
  293. 3Ofov
  294. q?r/0
  295. CO"/3?"/3?"/B?"/2?
  296. 3Ofov
  297. tOb?r/
  298. voSOP
  299. fogoe
  300. q/b/0
  301. VoUoUof
  302. VovoU_ 
  303. C?dod_
  304. WoVoVof
  305. V_foe_doeoeo
  306. e_d_UOe_EOU_U_U_F_EoF_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_EOU_UoeoF_EoF_U_V_UoF_E_VoUoE_Uo
  307. rdump
  308. #file system dump across the network
  309. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  310. \margl40
  311. \margr40
  312. {\colortbl;\red0\green0\blue0;}
  313. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b\i0\ulnone\fs24\fc1\cf1 rdump
  314. \b0  copies to magnetic tape all files changed after a certain date in the filesystem. The command is identical in operation to dump(8) except the f key should be specified and the file supplied should be of the form machine:device.\
  315. Rdump creates a remote server, /usr/etc/rmt, on the client machine to access the tape device.
  316. e_U_U_U_T_U_U_U_e_U_eoU_U_U_eoU_eoU_eoU_T_U_e_UOe_U_U_U_T_U_UoU_eoU_e_U_eoU_U_UOU_U_UoU_e_
  317. S?b?0
  318. R?S?0
  319. S/r?c?
  320. R?2/0
  321. b?S?R?C/0
  322. c?b?b/r?b/0
  323. U_3?4?
  324. 3/B/R/0
  325. b/r?C/S?T?S?
  326. SOC?C?
  327. b/b/R
  328. CO"/3?
  329. C/R/S/r?b
  330. r?b/b?0
  331. #?"?b?@
  332. #?"/3?2?2/ 
  333. /b/a/@
  334. /R/S/R?S/cOR/
  335. 3?2?3/B?2/C?3/
  336. 3?3?#/2/3/"/4?2/C?B?C/0
  337. e_vouo
  338. /a/R/B/
  339. R?A/R?B?"?#/C?3/3?#/2?#/2?
  340. S?R?2/B?$?#?#/3?#?#?#/3?3?3O#/3?#?"?#?3?
  341. 3Ofov
  342. q?r/0
  343. CO"/3?"/3?"/B?"/2?
  344. 3Ofov
  345. tOb?r/
  346. voSOP
  347. fogoe
  348. q/b/0
  349. VoUoUof
  350. VovoU_ 
  351. C?dod_
  352. WoVoVof
  353. V_foe_doeoeo
  354. e_d_UOe_EOU_U_U_F_EoF_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_EOU_UoeoF_EoF_U_V_UoF_E_VoUoE_Uo
  355. UUUUUUUUUUU@s
  356. fffff
  357. fffffff@
  358. r(fjd
  359. &ffffff`
  360. T&fffffd
  361. DDDD?
  362. DDDD@
  363. UUUUUUUUUUX
  364. restore
  365. incremental file system restore
  366. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  367. \margl40
  368. \margr40
  369. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b\i0\ulnone\fs24\fc0\cf0 restore
  370. \b0  reads tapes dumped with the dump(8) command. Its actions are controlled by the key argument. The key is a string of characters containing at most one function letter and possibly one or more function modifiers. Other arguments to the command are file or directory names specifying the files that are to be restored. Unless the h key is specified (see below), the appearance of a directory name refers to the files and (recursively) subdirectories of that directory.
  371. [13@]
  372. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  373. \margl40
  374. \margr40
  375. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The tape is read and loaded into the current directory. This should not be done lightly; the r key should only be used to restore a complete dump tape onto a clear file system or to restore an incremental dump tape after a full level zero restore. Thus\
  376.  /usr/etc/newfs /dev/rrp0g eagle /usr/etc/mount /dev/rp0g /mnt cd /mnt restore r\
  377.  is a typical sequence to restore a complete dump. Another restore can be done to get an incremental dump in on top of this. Note that restore leaves a file restoresymtab in the root directory to pass information between incremental restore passes. This file should be removed when the last incremental tape has been restored. A dump(8) followed by a newfs(8) and a restore is used to change the size of a file system
  378. V{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  379. \margl40
  380. \margr40
  381. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Restore requests a particular tape of a multi volume set on which to restart a full restore (see the r key above). This allows restore to be interrupted and then restarted.
  382. `{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  383. \margl40
  384. \margr40
  385. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The named files are extracted from the tape. If the named file matches a directory whose contents had been written onto the tape, and the h key is not specified, the directory is recursively extracted. The owner, modification time, and mode are restored (if possible). If no file argument is given, then the root directory is extracted, which results in the entire content of the tape being extracted, unless the h key has been specified.
  386. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  387. \margl40
  388. \margr40
  389. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The names of the specified files are listed if they occur on the tape. If no file argument is given, then the root directory is listed, which results in the entire content of the tape being listed, unless the h key has been specified. Note that the t key replaces the function of the old dumpdir program.
  390. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  391. \margl40
  392. \margr40
  393. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 This is required when restoring from ejectable media such as floppy or optical disk
  394. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  395. \margl40
  396. \margr40
  397. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 This mode allows interactive restoration of files from a dump tape. After reading in the directory information from the tape, restore provides a shell like interface that allows the user to move around the directory tree selecting files to be extracted. The available commands are given below
  398. Z{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  399. \margl40
  400. \margr40
  401. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The next argument to restore is used as the block size of the tape (in kilobytes). If the -b option is not specified, restore tries to determine the tape block size dynamically
  402.     blocksize
  403. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  404. \margl40
  405. \margr40
  406. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The block size of the tape in kilobytes
  407. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  408. \margl40
  409. \margr40
  410. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The next argument to restore is used as the name of the archive instead of /dev/rmt?. If the name of the file is ``-'', restore reads from standard input. Thus, dump(8) and restore can be used in a pipeline to dump and restore a file system with the command 
  411. \b dump 0f /usr | (cd /mnt; restore xf -)
  412. archivename
  413. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  414. \margl40
  415. \margr40
  416. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The name of the archive (instead of /dev/rmt?)
  417. 2{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  418. \margl40
  419. \margr40
  420. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Normally restore does its work silently. The v (verbose) key causes it to type the name of each file it treats preceded by its file type
  421. J{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  422. \margl40
  423. \margr40
  424. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Restore will not ask whether it should abort the restore if gets a tape error. It will always try to skip over the bad tape block(s) and continue as best it can
  425. g{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  426. \margl40
  427. \margr40
  428. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Restore will extract by inode numbers rather than by file name. This is useful if only a few files are being extracted, and one wants to avoid regenerating the complete pathname to the file
  429. D{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  430. \margl40
  431. \margr40
  432. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Restore extracts the actual directory, rather than the files that it references. This prevents hierarchical restoration of complete subtrees from the tape
  433. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  434. \margl40
  435. \margr40
  436. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The next argument to restore is a number which selects the file on a multi-file dump tape. File numbering starts at 1
  437. filenum
  438. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  439. \margl40
  440. \margr40
  441. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The number which selects the file on a multi-file dump tape
  442. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  443. \margl40
  444. \margr40
  445. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 Refers to the files and (recursively) subdirectories of that directory
  446. UUUUUUUUUUU@s
  447. fffff
  448. fffffff@
  449. r(fjd
  450. &ffffff`
  451. T&fffffd
  452. DDDD?
  453. DDDD@
  454. UUUUUUUUUUX
  455. e_U_U_U_T_U_U_U_e_U_eoU_U_U_eoU_eoU_eoU_T_U_e_UOe_U_U_U_T_U_UoU_eoU_e_U_eoU_U_UOU_U_UoU_e_
  456. S?b?0
  457. R?S?0
  458. S/r?c?
  459. R?2/0
  460. b?S?R?C/0
  461. c?b?b/r?b/0
  462. U_3?4?
  463. 3/B/R/0
  464. b/r?C/S?T?S?
  465. SOC?C?
  466. b/b/R
  467. CO"/3?
  468. C/R/S/r?b
  469. r?b/b?0
  470. #?"?b?@
  471. #?"/3?2?2/ 
  472. /b/a/@
  473. /R/S/R?S/cOR/
  474. 3?2?3/B?2/C?3/
  475. 3?3?#/2/3/"/4?2/C?B?C/0
  476. e_vouo
  477. /a/R/B/
  478. R?A/R?B?"?#/C?3/3?#/2?#/2?
  479. S?R?2/B?$?#?#/3?#?#?#/3?3?3O#/3?#?"?#?3?
  480. 3Ofov
  481. q?r/0
  482. CO"/3?"/3?"/B?"/2?
  483. 3Ofov
  484. tOb?r/
  485. voSOP
  486. fogoe
  487. q/b/0
  488. VoUoUof
  489. VovoU_ 
  490. C?dod_
  491. WoVoVof
  492. V_foe_doeoeo
  493. e_d_UOe_EOU_U_U_F_EoF_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_EOU_UoeoF_EoF_U_V_UoF_E_VoUoE_Uo
  494. remote magtape protocol module
  495. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  496. \margl40
  497. \margr40
  498. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b\i0\ulnone\fs24\fc0\cf0 rmt
  499. \b0  is a program used by the remote dump and restore programs in manipulating a magnetic tape drive through an interprocess communication connection. Rmt is normally started up with an rexec(3X) or rcmd(3X) call. The rmt program accepts requests specific to the manipulation of magnetic tapes, performs the commands, then responds with a status indication.
  500. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  501. \margl40
  502. \margr40
  503. {\colortbl;\red0\green0\blue0;}
  504. \pard\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\f0\b0\i0\ulnone\fs24\fc1\cf1 Open the specified 
  505. \i device
  506. \i0  using the indicated  
  507. \i mode
  508. \i0 . 
  509. \i Device
  510. \i0  is a full pathname and 
  511. \i mode
  512. \i0  is an ASCII representation of a decimal number suitable for passing to 
  513. \i open
  514. \i0 (2). If a device had already been opened, it is closed before a new open is performed
  515. device
  516. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  517. \margl40
  518. \margr40
  519. \pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc0\cf0 The device to be opened
  520. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  521. \margl40
  522. \margr40
  523. \pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc0\cf0 The mode used when opening the 
  524. \b device
  525. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  526. \margl40
  527. \margr40
  528. {\colortbl;\red0\green0\blue0;}
  529. \pard\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\f0\b0\i0\ulnone\fs24\fc1\cf1 Close the currently open device. The 
  530. \i device
  531. \i0  specified is ignored
  532. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  533. \margl40
  534. \margr40
  535. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The device to be closed
  536. 1{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  537. \margl40
  538. \margr40
  539. {\colortbl;\red0\green0\blue0;}
  540. \pard\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\f0\b0\i0\ulnone\fs24\fc1\cf1 Perform an 
  541. \i lseek
  542. \i0 (2) operation using the specified parameters. The response value is that returned from the 
  543. \i lseek
  544. \i0  call
  545. whence
  546. L_SET
  547. ${\rtf0\ansi{\fonttbl\f0\fmodern Courier;\f1\fswiss Helvetica;}
  548. \margl40
  549. \margr40
  550. {\colortbl;\red0\green0\blue0;}
  551. \pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc1\cf1 If 
  552. \i whence
  553. \i0  is L_SET, the pointer is set to 
  554. \i offset
  555. \i0  bytes
  556. L_INCR
  557. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;\f1\fswiss Helvetica;}
  558. \margl40
  559. \margr40
  560. {\colortbl;\red0\green0\blue0;}
  561. \pard\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\f0\b0\i0\ulnone\fs24\fc1\cf1 If 
  562. \i whence
  563. \i0  is L_INCR, the pointer is set to its current location plus 
  564. \i offset
  565. L_XTND
  566. 4{\rtf0\ansi{\fonttbl\f0\fmodern Courier;\f1\fswiss Helvetica;}
  567. \margl40
  568. \margr40
  569. {\colortbl;\red0\green0\blue0;}
  570. \pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc1\cf1 If 
  571. \i whence
  572. \i0  is L_XTND, the pointer is set to the size of the file plus 
  573. \i offset
  574. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  575. \margl40
  576. \margr40
  577. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 Sets the file pointer depending on value
  578. offset
  579. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  580. \margl40
  581. \margr40
  582. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The number of bytes to be offset
  583. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  584. \margl40
  585. \margr40
  586. {\colortbl;\red0\green0\blue0;}
  587. \pard\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\f0\b0\i0\ulnone\fs24\fc1\cf1 Write data onto the open device.  
  588. \i Rmt
  589. \i0  reads 
  590. \i count
  591. \i0  bytes from the connection, aborting if a premature end-of-file is encountered. The response value is that returned from the 
  592. \i write
  593. \i0 (2) call.
  594. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  595. \margl40
  596. \margr40
  597. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The number of bytes to read from the connection
  598. I{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  599. \margl40
  600. \margr40
  601. {\colortbl;\red0\green0\blue0;}
  602. \pard\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\f0\b0\i0\ulnone\fs24\fc1\cf1 Read 
  603. \i count
  604. \i0  bytes of data from the open device. If 
  605. \i count
  606. \i0  exceeds the size of the data buffer (10 kilobytes), it is truncated to the data buffer size.  
  607. \i Rmt
  608. \i0  then performs the requested 
  609. \i read
  610. \i0 (2) and responds with A
  611. \i count
  612. \i0 -
  613. \i read
  614. \i0 \\n if the read was successful; otherwise an error in the standard format is returned.  If the read was successful, the data read is then sent
  615. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  616. \margl40
  617. \margr40
  618. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The number of bytes to read from the open device
  619. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  620. \margl40
  621. \margr40
  622. {\colortbl;\red0\green0\blue0;}
  623. \pard\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\f0\b0\i0\ulnone\fs24\fc1\cf1 Perform a MTIOCOP 
  624. \i ioctl
  625. \i0 (2) command using the specified parameters.  The parameters are interpreted as the ASCII representations of the decimal values to place in the 
  626. \i mt
  627. \i0 _
  628. \i op
  629. \i0  and 
  630. \i mt
  631. \i0 _
  632. \i count
  633. \i0  fields of the structure used in the 
  634. \i ioctl
  635. \i0  call.  The return value is the 
  636. \i count
  637. \i0  parameter when the operation is successful.
  638.     operation
  639. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  640. \margl40
  641. \margr40
  642. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The ASCII value to place in the 
  643. \i mt_op
  644. \i0  field of the structure used in the 
  645. \i ioctl
  646. \i0  call
  647. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  648. \margl40
  649. \margr40
  650. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The ASCII value to place in the 
  651. \i mt_count
  652. \i0  field of the structure used in the 
  653. \i ioctl
  654. \i0  call
  655. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  656. \margl40
  657. \margr40
  658. {\colortbl;\red0\green0\blue0;}
  659. \pard\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\tx0\f0\b0\i0\ulnone\fs24\fc1\cf1 Return the status of the open device, as obtained with a MTIOCGET 
  660. \i ioctl
  661. \i0  call. If the operation was successful, an ``ack'' is sent with the size of the status buffer, then the status buffer is sent (in binary)
  662. UUUUUUUUUUU@s
  663. fffff
  664. fffffff@
  665. r(fjd
  666. &ffffff`
  667. T&fffffd
  668. DDDD?
  669. DDDD@
  670. UUUUUUUUUUX
  671. e_U_U_U_T_U_U_U_e_U_eoU_U_U_eoU_eoU_eoU_T_U_e_UOe_U_U_U_T_U_UoU_eoU_e_U_eoU_U_UOU_U_UoU_e_
  672. S?b?0
  673. R?S?0
  674. S/r?c?
  675. R?2/0
  676. b?S?R?C/0
  677. c?b?b/r?b/0
  678. U_3?4?
  679. 3/B/R/0
  680. b/r?C/S?T?S?
  681. SOC?C?
  682. b/b/R
  683. CO"/3?
  684. C/R/S/r?b
  685. r?b/b?0
  686. #?"?b?@
  687. #?"/3?2?2/ 
  688. /b/a/@
  689. /R/S/R?S/cOR/
  690. 3?2?3/B?2/C?3/
  691. 3?3?#/2/3/"/4?2/C?B?C/0
  692. e_vouo
  693. /a/R/B/
  694. R?A/R?B?"?#/C?3/3?#/2?#/2?
  695. S?R?2/B?$?#?#/3?#?#?#/3?3?3O#/3?#?"?#?3?
  696. 3Ofov
  697. q?r/0
  698. CO"/3?"/3?"/B?"/2?
  699. 3Ofov
  700. tOb?r/
  701. voSOP
  702. fogoe
  703. q/b/0
  704. VoUoUof
  705. VovoU_ 
  706. C?dod_
  707. WoVoVof
  708. V_foe_doeoeo
  709. e_d_UOe_EOU_U_U_F_EoF_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_EOU_UoeoF_EoF_U_V_UoF_E_VoUoE_Uo
  710. rrestore
  711. -Restore a file system dump across the network
  712. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  713. \margl40
  714. \margr40
  715. {\colortbl;\red0\green0\blue0;}
  716. \pard\tx0\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\f0\b\i0\ulnone\fs24\fc1\cf1 rrestore
  717. \b0  obtains from magnetic tape files saved by a previous dump(8).  The command is identical in operation to restore(8) except the f key should be specified and the file supplied should be of the form machine:device.\
  718. Rrestore creates a remote server, /usr/etc/rmt, on the client machine to access the tape device.
  719. UUUUUUUUUUU@s
  720. fffff
  721. fffffff@
  722. r(fjd
  723. &ffffff`
  724. T&fffffd
  725. DDDD?
  726. DDDD@
  727. UUUUUUUUUUX
  728. e_U_U_U_T_U_U_U_e_U_eoU_U_U_eoU_eoU_eoU_T_U_e_UOe_U_U_U_T_U_UoU_eoU_e_U_eoU_U_UOU_U_UoU_e_
  729. S?b?0
  730. R?S?0
  731. S/r?c?
  732. R?2/0
  733. b?S?R?C/0
  734. c?b?b/r?b/0
  735. U_3?4?
  736. 3/B/R/0
  737. b/r?C/S?T?S?
  738. SOC?C?
  739. b/b/R
  740. CO"/3?
  741. C/R/S/r?b
  742. r?b/b?0
  743. #?"?b?@
  744. #?"/3?2?2/ 
  745. /b/a/@
  746. /R/S/R?S/cOR/
  747. 3?2?3/B?2/C?3/
  748. 3?3?#/2/3/"/4?2/C?B?C/0
  749. e_vouo
  750. /a/R/B/
  751. R?A/R?B?"?#/C?3/3?#/2?#/2?
  752. S?R?2/B?$?#?#/3?#?#?#/3?3?3O#/3?#?"?#?3?
  753. 3Ofov
  754. q?r/0
  755. CO"/3?"/3?"/B?"/2?
  756. 3Ofov
  757. tOb?r/
  758. voSOP
  759. fogoe
  760. q/b/0
  761. VoUoUof
  762. VovoU_ 
  763. C?dod_
  764. WoVoVof
  765. V_foe_doeoeo
  766. e_d_UOe_EOU_U_U_F_EoF_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_EOU_UoeoF_EoF_U_V_UoF_E_VoUoE_Uo
  767. 5create file storage archive for extraction by /bin/sh
  768. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  769. \margl40
  770. \margr40
  771. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b\i0\ulnone\fs24\fc0\cf0 shar
  772. \b0  prints its input files with special command lines around them to be used by the shell /bin/sh to extract them later. The output can be filtered through the shell to recreate copies of the original files.\
  773. \b shar
  774. \b0  allows directories to be named, and shar prints the necessary commands (mkdir & cd) to create new directories and fill them. shar will produce commands to make executable plain files executable. shar will not allow existing files to be over-written; such files must be removed by the file extractor.
  775. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  776. \margl40
  777. \margr40
  778. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 All the options. The options: -v -c -b -p <tab>X are implied
  779. O{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  780. \margl40
  781. \margr40
  782. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Extract files into basenames so that files with absolute path names are put into the current directory. This option has strange effects when directories are archived
  783. u{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  784. \margl40
  785. \margr40
  786. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Check file size on extraction by counting characters. An error message is reported if the sizes don't match. One reason why the sizes may not match is that shar will append a newline to complete incomplete last lines; shar prints a message that mentions added newlines. Another reason why the sizes may not match is that some network mail programs remove non-whitespace control characters. On extraction, shar prints a message that mentions control characters
  787. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  788. \margl40
  789. \margr40
  790. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Silent running. All checking and extra output is inhibited
  791. ${\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  792. \margl40
  793. \margr40
  794. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Print verbose feedback messages about what shar is doing. Sizes of plain files are echoed to allow a simple validity check
  795. K{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  796. \margl40
  797. \margr40
  798. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Use this as the ``end of file'' delimiter instead of the default. The only reason to change it is if you suspect an file contains the default delimiter: SHAR_EOF
  799. delim
  800. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  801. \margl40
  802. \margr40
  803. \f0\b0\i0\ulnone\ql\fs24\fi0\li0\gray0\fc0\cf0\up0\dn0 The delimiter to be used
  804. 3{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  805. \margl40
  806. \margr40
  807. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Use this as the prefix to each line of the archived files. This is to make sure that special characters at the start of lines are not eaten up by programs like mailers. If this option is used, the files will be extracted with the stream editor sed rather than cat so it is more efficient and portable to avoid setting the prefix, though perhaps less safe if you don't know what is in the files
  808. prefix
  809. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  810. \margl40
  811. \margr40
  812. \pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc0\cf0 The prefix to each line of the file
  813. files
  814. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  815. \margl40
  816. \margr40
  817. \f0\b0\i0\ulnone\ql\fs24\fi0\li0\gray0\fc0\cf0\up0\dn0 The input file(s) to be processed
  818. UUUUUUUUUUU@s
  819. fffff
  820. fffffff@
  821. r(fjd
  822. &ffffff`
  823. T&fffffd
  824. DDDD?
  825. DDDD@
  826. UUUUUUUUUUX
  827. e_U_U_U_T_U_U_U_e_U_eoU_U_U_eoU_eoU_eoU_T_U_e_UOe_U_U_U_T_U_UoU_eoU_e_U_eoU_U_UOU_U_UoU_e_
  828. S?b?0
  829. R?S?0
  830. S/r?c?
  831. R?2/0
  832. b?S?R?C/0
  833. c?b?b/r?b/0
  834. U_3?4?
  835. 3/B/R/0
  836. b/r?C/S?T?S?
  837. SOC?C?
  838. b/b/R
  839. CO"/3?
  840. C/R/S/r?b
  841. r?b/b?0
  842. #?"?b?@
  843. #?"/3?2?2/ 
  844. /b/a/@
  845. /R/S/R?S/cOR/
  846. 3?2?3/B?2/C?3/
  847. 3?3?#/2/3/"/4?2/C?B?C/0
  848. e_vouo
  849. /a/R/B/
  850. R?A/R?B?"?#/C?3/3?#/2?#/2?
  851. S?R?2/B?$?#?#/3?#?#?#/3?3?3O#/3?#?"?#?3?
  852. 3Ofov
  853. q?r/0
  854. CO"/3?"/3?"/B?"/2?
  855. 3Ofov
  856. tOb?r/
  857. voSOP
  858. fogoe
  859. q/b/0
  860. VoUoUof
  861. VovoU_ 
  862. C?dod_
  863. WoVoVof
  864. V_foe_doeoeo
  865. e_d_UOe_EOU_U_U_F_EoF_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_EOU_UoeoF_EoF_U_V_UoF_E_VoUoE_Uo
  866. tape archiver
  867. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  868. \margl40
  869. \margr40
  870. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b\i0\ulnone\fs24\fc0\cf0 tar
  871. \b0  saves and restores multiple files on a single file (usually a magnetic tape, but it can be any file). Tar's actions are controlled by the key argument. The key is a string of characters containing at most one function letter and possibly one or more function modifiers. Other arguments to tar are file or directory names specifying which files to dump or restore. In all cases, appearance of a directory name refers to the files and (recursively) subdirectories of that directory.
  872. [26@]
  873. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  874. \margl40
  875. \margr40
  876. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The named files are written on the end of the tape. The c function implies this
  877. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  878. \margl40
  879. \margr40
  880. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The files to be written onto the end of the tape
  881. P{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  882. \margl40
  883. \margr40
  884. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The named files are extracted from the tape. If the named file matches a directory whose contents had been written onto the tape, this directory is (recursively) extracted. The owner, modification time, and mode are restored (if possible). If no file argument is given, the entire content of the tape is extracted. Note that if multiple entries specifying the same file are on the tape, the last one overwrites all earlier
  885. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  886. \margl40
  887. \margr40
  888. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The files to be extracted from the tape
  889. >{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  890. \margl40
  891. \margr40
  892. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The names of the specified files are listed each time they occur on the tape. If no file argument is given, all of the names on the tape are listed.
  893. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  894. \margl40
  895. \margr40
  896. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The files to be listed each time they occur on the tape
  897. %{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  898. \margl40
  899. \margr40
  900. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The named files are added to the tape if either they are not already there or have been modified since last put on the tape
  901. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  902. \margl40
  903. \margr40
  904. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The files to be added to the tape if they're not already there or have been modified
  905. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  906. \margl40
  907. \margr40
  908. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Create a new tape; writing begins on the beginning of the tape instead of after the last file. This command implies r
  909. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  910. \margl40
  911. \margr40
  912. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 On output, tar normally places information specifying owner and modes of directories in the archive. Former versions of tar, when encountering this information will give error message of the form "<name>/: cannot create". This modifier will suppress the directory information
  913. K{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  914. \margl40
  915. \margr40
  916. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 This modifier says to restore files to their original modes, ignoring the present umask(2). Setuid and sticky information will also be restored to the super-user
  917. 0{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  918. \margl40
  919. \margr40
  920. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 This modifier selects an alternate drive on which the tape is mounted. The default is drive 0 at 1600 bpi, which is normally /dev/rxt8
  921. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  922. \margl40
  923. \margr40
  924. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Normally tar does its work silently. The v (verbose) option makes tar print the name of each file it treats preceded by the function letter. With the t function, the verbose option gives more information about the tape entries than just their names
  925. `{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  926. \margl40
  927. \margr40
  928. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Tar prints the action to be taken followed by file name, then wait for user confirmation. If a word beginning with `y' is given, the action is done. Any other input means don't do it
  929. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  930. \margl40
  931. \margr40
  932. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Tar uses the next argument as the name of the archive instead of /dev/rxt?. If the name of the file is `-', tar writes to standard output or reads from standard input, whichever is appropriate. Thus, tar can be used as the head or tail of a filter chain. Tar can also be used to move hierarchies with the command cd fromdir; tar cf . | (cd todir; tar xf -)
  933. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  934. \margl40
  935. \margr40
  936. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The archive's name (instead of /dev/rxt?)
  937. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  938. \margl40
  939. \margr40
  940. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Tar uses the next argument as the blocking factor for tape records. The default is 20 (the maximum). This option should only be used with raw magnetic tape archives (See f above). The block size is determined automatically when reading tapes (key letters `x' and `t')
  941. blockingfactor
  942. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  943. \margl40
  944. \margr40
  945. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The blocking factor for tape records
  946. 2{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  947. \margl40
  948. \margr40
  949. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Tells tar to complain if it cannot resolve all of the links to the files dumped. If this is not specified, no error messages are printed
  950. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  951. \margl40
  952. \margr40
  953. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Tells tar not to restore the modification times. The modification time will be the time of extraction
  954. &{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  955. \margl40
  956. \margr40
  957. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Force tar to follow symbolic links as if they were normal files or directories. Normally, tar does not follow symbolic links
  958. W{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  959. \margl40
  960. \margr40
  961. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Forces input and output blocking to 20 blocks per record. This option was added so that tar can work across a communications channel where the blocking may not be maintained
  962. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  963. \margl40
  964. \margr40
  965. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 If a file name is preceded by -C, then tar will perform a chdir(2) to that file name. This allows multiple directories not related by a close common parent to be archived using short relative path names. For example, to archive files from /usr/include and from /etc, one might use 
  966. \b tar c -C /usr include -C / etc
  967. UUUUUUUUUUU@s
  968. fffff
  969. fffffff@
  970. r(fjd
  971. &ffffff`
  972. T&fffffd
  973. DDDD?
  974. DDDD@
  975. UUUUUUUUUUX
  976. e_U_U_U_T_U_U_U_e_U_eoU_U_U_eoU_eoU_eoU_T_U_e_UOe_U_U_U_T_U_UoU_eoU_e_U_eoU_U_UOU_U_UoU_e_
  977. S?b?0
  978. R?S?0
  979. S/r?c?
  980. R?2/0
  981. b?S?R?C/0
  982. c?b?b/r?b/0
  983. U_3?4?
  984. 3/B/R/0
  985. b/r?C/S?T?S?
  986. SOC?C?
  987. b/b/R
  988. CO"/3?
  989. C/R/S/r?b
  990. r?b/b?0
  991. #?"?b?@
  992. #?"/3?2?2/ 
  993. /b/a/@
  994. /R/S/R?S/cOR/
  995. 3?2?3/B?2/C?3/
  996. 3?3?#/2/3/"/4?2/C?B?C/0
  997. e_vouo
  998. /a/R/B/
  999. R?A/R?B?"?#/C?3/3?#/2?#/2?
  1000. S?R?2/B?$?#?#/3?#?#?#/3?3?3O#/3?#?"?#?3?
  1001. 3Ofov
  1002. q?r/0
  1003. CO"/3?"/3?"/B?"/2?
  1004. 3Ofov
  1005. tOb?r/
  1006. voSOP
  1007. fogoe
  1008. q/b/0
  1009. VoUoUof
  1010. VovoU_ 
  1011. C?dod_
  1012. WoVoVof
  1013. V_foe_doeoeo
  1014. e_d_UOe_EOU_U_U_F_EoF_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_EOU_UoeoF_EoF_U_V_UoF_E_VoUoE_Uo
  1015. tcopy
  1016. copy a mag tape
  1017. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1018. \margl40
  1019. \margr40
  1020. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b\i0\ulnone\fs24\fc0\cf0 tcopy
  1021. \b0  is designed to copy magnetic tapes. The only assumption made about the tape is that there are two tape marks at the end. Tcopy with only a source tape specified will print information about the sizes of records and tape files. If a destination is specified, then, a copy will be made of the source tape. The blocking on the destination tape will be identical to that used on the source tape. Copying a tape will yield the same output as if just printing the sizes.
  1022. source
  1023. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1024. \margl40
  1025. \margr40
  1026. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The source tape
  1027. destination
  1028. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1029. \margl40
  1030. \margr40
  1031. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The destination tape
  1032. UUUUUUUUUUU@s
  1033. fffff
  1034. fffffff@
  1035. r(fjd
  1036. &ffffff`
  1037. T&fffffd
  1038. DDDD?
  1039. DDDD@
  1040. UUUUUUUUUUX
  1041. e_U_U_U_T_U_U_U_e_U_eoU_U_U_eoU_eoU_eoU_T_U_e_UOe_U_U_U_T_U_UoU_eoU_e_U_eoU_U_UOU_U_UoU_e_
  1042. S?b?0
  1043. R?S?0
  1044. S/r?c?
  1045. R?2/0
  1046. b?S?R?C/0
  1047. c?b?b/r?b/0
  1048. U_3?4?
  1049. 3/B/R/0
  1050. b/r?C/S?T?S?
  1051. SOC?C?
  1052. b/b/R
  1053. CO"/3?
  1054. C/R/S/r?b
  1055. r?b/b?0
  1056. #?"?b?@
  1057. #?"/3?2?2/ 
  1058. /b/a/@
  1059. /R/S/R?S/cOR/
  1060. 3?2?3/B?2/C?3/
  1061. 3?3?#/2/3/"/4?2/C?B?C/0
  1062. e_vouo
  1063. /a/R/B/
  1064. R?A/R?B?"?#/C?3/3?#/2?#/2?
  1065. S?R?2/B?$?#?#/3?#?#?#/3?3?3O#/3?#?"?#?3?
  1066. 3Ofov
  1067. q?r/0
  1068. CO"/3?"/3?"/B?"/2?
  1069. 3Ofov
  1070. tOb?r/
  1071. voSOP
  1072. fogoe
  1073. q/b/0
  1074. VoUoUof
  1075. VovoU_ 
  1076. C?dod_
  1077. WoVoVof
  1078. V_foe_doeoeo
  1079. e_d_UOe_EOU_U_U_F_EoF_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_EOU_UoeoF_EoF_U_V_UoF_E_VoUoE_Uo
  1080. manipulate tape archive
  1081. q{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1082. \margl40
  1083. \margr40
  1084. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b\i0\ulnone\fs24\fc0\cf0 tp
  1085. \b0  saves and restores files on DECtape or magtape. Its actions are controlled by the key argument. The key is a string of characters containing at most one function letter and possibly one or more function modifiers. Other arguments to the command are file or directory names specifying which files are to be dumped, restored, or listed. In all cases, appearance of a directory name refers to the files and (recursively) subdirectories of that directory.
  1086. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1087. \margl40
  1088. \margr40
  1089. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The named files are written on the tape. If files with the same names already exist, they are replaced. `Same' is determined by string comparison, so `./abc' can never be the same as `/usr/dmr/abc' even if `/usr/dmr' is the current directory. If no file argument is given, `.' is the default.
  1090. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1091. \margl40
  1092. \margr40
  1093. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The files to be written to the tape
  1094. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1095. \margl40
  1096. \margr40
  1097. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 updates the tape. u is like r, but a file is replaced only if its modification date is later than the date stored on the tape; that is to say, if it has changed since it was dumped. u is the default command if none is given
  1098. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1099. \margl40
  1100. \margr40
  1101. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The files to be written on the tape
  1102. %{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1103. \margl40
  1104. \margr40
  1105. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Deletes the named files from the tape. At least one name argument must be given. This function is not permitted on magtapes
  1106. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1107. \margl40
  1108. \margr40
  1109. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The files to be deleted from the tape
  1110. Q{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1111. \margl40
  1112. \margr40
  1113. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Extracts the named files from the tape to the file system. The owner and mode are restored. If no file argument is given, the entire contents of the tape are extracted
  1114. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1115. \margl40
  1116. \margr40
  1117. \f0\b0\i0\ulnone\ql\fs24\fi0\li0\gray0\fc0\cf0\up0\dn0 The files to be extracted from the tape
  1118. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1119. \margl40
  1120. \margr40
  1121. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Lists the names of the specified files. If no file argument is given, the entire contents of the tape is listed
  1122.     filenames
  1123. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1124. \margl40
  1125. \margr40
  1126. \pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc0\cf0 The files to be listed
  1127. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1128. \margl40
  1129. \margr40
  1130. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Specifies magtape as opposed to DECtape
  1131. !{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1132. \margl40
  1133. \margr40
  1134. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 This modifier selects the drive on which the tape is mounted. For DECtape, x is default; for magtape `0' is the default
  1135. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1136. \margl40
  1137. \margr40
  1138. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Normally tp does its work silently. The v (verbose) option causes it to type the name of each file it treats preceded by the function letter. With the t function, v gives more information about the tape entries than just the name
  1139. t{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1140. \margl40
  1141. \margr40
  1142. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 means a fresh dump is being created; the tape directory is cleared before beginning. Usable only with r and u. This option is assumed with magtape since it is impossible to selectively overwrite magtape
  1143. %{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1144. \margl40
  1145. \margr40
  1146. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Errors reading and writing the tape are noted, but no action is taken. Normally, errors cause a return to the command level
  1147. >{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1148. \margl40
  1149. \margr40
  1150. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Use the first named file, rather than a tape, as the archive. This option currently acts like m; i.e. r implies c, and neither d nor u are permitted
  1151. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1152. \margl40
  1153. \margr40
  1154. \f0\b0\i0\ulnone\ql\fs24\fi0\li0\gray0\fc0\cf0\up0\dn0 The file to be used as the archive
  1155. v{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1156. \margl40
  1157. \margr40
  1158. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Causes tp to pause before treating each file, type the indicative letter and the file name (as with v) and await the user's response. Response y means `yes', so the file is treated. Null response means `no', and the file does not take part in whatever is being done. Response x means `exit'; the tp command terminates immediately. In the x function, files previously asked about have been extracted already. With r, u, and d no change has been made to the tape
  1159. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  1160. \margl40
  1161. \margr40
  1162. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The files to be dumped, restored or listed
  1163.